<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>Details</title>
<style type="text/css">
html { height: 100%; }
body {
  font-family: sans-serif;
  margin: 0; padding: 0;
  background-color: #ffffff;
  color: #000000;
  direction: ltr;
}
article, aside, nav, header, footer, section {
  display: block;
  margin: 0;
  padding: 0;
}
main {
  display: flex;
  flex-flow: row;
}
main > * {
  flex: 0 0 220px;
}
main > div.page {
  flex-grow: 1;
  margin: 0;
  display: flex;
  flex-flow: column;
  align-items: stretch;
  justify-content: flex-start;
  min-height: 100vh;
}
div.page > article { flex: 1 0 auto; }
div.page > header, div.page > footer { flex: 0 1 auto; }
.pagewide {
  max-width: 940px;
  margin-left: auto;
  margin-right: auto;
  padding-left: 10px;
  padding-right: 10px;
}
aside.sidebar {
  width: 300px;
  padding: 20px 10px;
  background: rgb(244,244,244)
}
aside.sidebar-right { order: 3; }
aside.sidebar section { margin-top: 0; }
aside.sidebar * { margin-bottom: 20px; }
aside.sidebar section > div.inner > div.hgroup {
  border-bottom: none;
}
aside.sidebar section h2 {
  font-size: 1em;
  margin-bottom: 0;
}
article {
  padding-top: 10px;
  padding-bottom: 10px;
  min-height: 20em;
  background-color: #ffffff;
}
section {
  margin-top: 2.4em;
  clear: both;
}
section section {
  margin-top: 1.44em;
}
.yelp-hash-highlight {
  animation-name: yelp-hash-highlight;
  animation-duration: 0.5s;
  animation-fill-mode: forwards;
}
@keyframes yelp-hash-highlight {
  from { transform: translateY(0px) }
  25%  { transform: translateY(20px); }
  50%  { transform: translateY(0); }
  75%  { transform: translateY(10px); }
  to   { transform: translateY(0px); }
}
div.trails {
  margin: 0 -10px 0 -10px;
  padding: 0.2em 10px;
  background-color: rgb(244,244,244);
}
div.trail {
  margin: 0.2em 0;
  padding: 0 1em 0 1em;
  text-indent: -1em;
  color: rgb(75,75,73);
}
a.trail { white-space: nowrap; }
div.hgroup {
  margin-bottom: 0.5em;
  color: rgb(75,75,73);
}
section > div.inner > div.hgroup {
  margin-top: 0;
  border-bottom: solid 1px #c0bfbc;
}
section.links > div.inner > div.hgroup {
  border-bottom: solid 2px rgb(43,107,185);
}
section section.links > div.inner > div.hgroup {
  border: none;
}
h1, h2, h3, h4, h5, h6, h7 {
  margin: 0; padding: 0;
  color: rgb(75,75,73);
  font-weight: bold;
}
h1 { font-size: 2em; }
h2 { font-size: 1.44em; }
h3.title, h4.title, h5.title, h6.title, h7.title { font-size: 1.2em; }
h3, h4, h5, h6, h7 { font-size: 1em; }
p { line-height: 1.44em; }
div, pre, p { margin: 0; padding: 0; }
div.contents > * + *,
th > * + *, td > * + *,
dt > * + *, dd > * + *,
li > * + * { margin-top: 1em; }
p img { vertical-align: middle; }
p.lead { font-size: 1.2em; }
div.clear {
  margin: 0; padding: 0;
  height: 0; line-height: 0;
  clear: both;
}
.center { text-align: center; }

footer.about { margin: 0; }
footer.about > div.inner > div.hgroup {
  margin: 0; padding: 0;
  text-align: center;
  border: none;
}
footer.about > div.inner > div.hgroup > h2 {
  margin: 0; padding: 0.2em;
  font-size: inherit;
}
footer.about.ui-expander > div.inner > div.hgroup span.title:before {
  content: "";
}
div.copyrights {
  max-width: 700px;
  text-align: center;
  padding: 10px;
  margin: 0 auto;
}
div.copyright { margin: 0; }
div.credits {
  display: flex;
  flex-flow: row wrap;
  align-items: stretch;
  justify-content: flex-start;
  max-width: 720px;
  margin: 0 auto;
}
div.credits > * {
  vertical-align: top;
  text-align: left;
  flex: 1 0 220px;
  margin: 0;
  padding: 10px;
}
div.credits > *:empty { padding: 0 10px; height: 0; }
ul.credits, ul.credits li {
  margin: 0; padding: 0;
  list-style-type: none;
}
ul.credits li {
  margin-left: 1em;
  text-indent: -1em;
}
div.license {
  max-width: 700px;
  margin: 0 auto;
  padding: 10px;
}

table {
  border-collapse: collapse;
  border-color: #c0bfbc;
  border-width: 1px;
}
td, th {
  padding: 0.5em;
  vertical-align: top;
  border-color: #c0bfbc;
  border-width: 1px;
}
thead td, thead th, tfoot td, tfoot th {
  font-weight: bold;
  color: rgb(75,75,73);
  background-color: rgb(234,234,233);
}
th {
  text-align: left;
  font-weight: bold;
  color: rgb(75,75,73);
}

ul, ol, dl { margin: 0; padding: 0; }
li {
  margin: 1em 0 0 0;
  margin-left: 2.4em;
  padding: 0;
}
li:first-child { margin-top: 0; }
@media (max-width: 480px) {
  li {
    margin-left: 1.44em;
  }
}
dt { margin-top: 1em; }
dt:first-child { margin-top: 0; }
dt + dt { margin-top: 0; }
dd {
  margin: 0.2em 0 0 0;
  margin-left: 1.44em;
}
dd + dd { margin-top: 1em; }
ol.compact li { margin-top: 0.2em; }
ul.compact li { margin-top: 0.2em; }
ol.compact li:first-child { margin-top: 0; }
ul.compact li:first-child { margin-top: 0; }
dl.compact dt { margin-top: 0.2em; }
dl.compact dt:first-child { margin-top: 0; }
dl.compact dt + dt { margin-top: 0; }

a {
  text-decoration: none;
  color: rgb(43,107,185);
}
a:visited { color: rgb(147,64,167); }
a:hover {
  border-bottom: dotted 1px rgb(43,107,185);
}
p a {
  border-bottom: dotted 1px rgb(43,107,185);
}
a img { border: none; }

.yelp-svg-fill {
  fill: rgb(75,75,73);
}
.yelp-svg-stroke {
  stroke: rgb(75,75,73);
}
div.title {
  margin: 0 0 0.2em 0;
  font-weight: bold;
  color: rgb(75,75,73);
}
div.title h1, div.title h2, div.title h3, div.title h4, div.title h5, div.title h6 {
  margin: 0;
  font-size: inherit;
  font-weight: inherit;
  color: inherit;
}
div.desc { margin: 0 0 0.2em 0; }
div.contents + div.desc { margin: 0.2em 0 0 0; }
pre.contents {
  padding: 0.5em 1em 0.5em 1em;
}
div.links-center { text-align: center; }
div.links .desc { color: rgb(102,102,100); }
div.links > div.inner > div.region > div.desc { font-style: italic; }
div.links ul { margin: 0; padding: 0; }
div.links ul ul {
  margin-left: 1em;
}
li.links {
  margin: 0.5em 0 0.5em 0;
  padding: 0;
  list-style-type: none;
}
li.links-head {
  margin-top: 1em;
  color: rgb(102,102,100);
  border-bottom: solid 1px #c0bfbc;
}
div.sectionlinks {
  display: inline-block;
  padding: 0 1em 0 1em;
  background-color: rgb(241,246,253);
  border: solid 1px rgb(43,107,185);
}
div.sectionlinks ul { margin: 0; }
div.sectionlinks li { padding: 0; }
div.sectionlinks div.title { margin: 0.5em 0 0.5em 0; }
div.sectionlinks div.sectionlinks {
  display: block;
  margin: 0.5em 0 0 0;
  padding: 0;
  border: none;
}
div.sectionlinks div.sectionlinks li {
  padding-left: 1.44em;
}
nav.prevnext { clear: both; }
div.region > nav.prevnext, div.region + nav.prevnext { margin-top: 1em; }
nav.prevnext > div.inner { float: right; }
nav.prevnext > div.inner > * {
  background-color: rgb(244,244,244);
  display: inline-block;
  position: relative;
  height: 1.44em;
  padding: 0.2em 0.83em 0 0.83em;
  margin-bottom: 1em;
  border: solid 1px #c0bfbc;
}
nav.prevnext > div.inner > span { visibility: hidden; }
nav.prevnext > div.inner > a + a {
  border-left: none;
}
nav.prevnext > div.inner > a:first-child {
  border-top-left-radius: 2px;
  border-bottom-left-radius: 2px;
}
nav.prevnext > div.inner > a:last-of-type {
  border-top-right-radius: 2px;
  border-bottom-right-radius: 2px;
}
div.serieslinks {
  display: inline-block;
  padding: 0 1em 0 1em;
  background-color: rgb(241,246,253);
  border: solid 1px rgb(43,107,185);
}
div.serieslinks ul { margin: 0; }
div.serieslinks li { padding: 0; }
div.serieslinks div.title { margin: 0.5em 0 0.5em 0; }
pre.numbered {
  margin: 0;
  padding: 0.5em;
  float: left;
  margin-right: 0.5em;
  text-align: right;
  color: rgb(102,102,100);
  background-color: rgb(253,251,233);
}
div.code {
  border: solid 1px #c0bfbc;
}
div.example {
  border-left: solid 4px #c0bfbc;
  padding-left: 1em;
}
div.example > div.inner > div.region > div.desc { font-style: italic; }
div.figure {
  display: inline-block;
  max-width: 100%;
  margin-left: 1.72em;
}
div.figure > div.inner {
  padding: 4px;
  color: rgb(75,75,73);
  border: solid 1px #c0bfbc;
  background-color: rgb(244,244,244);
}
@media (max-width: 960px) {
  div.figure {
    margin-left: 0;
  }
}
a.figure-zoom {
  float: right;
}
a.figure-zoom:hover { border-bottom: none; }
a.figure-zoom:hover .yelp-svg-fill { fill: #3584e4; }
a.figure-zoom:hover .yelp-svg-stroke { stroke: #3584e4; }
a.figure-zoom .figure-zoom-out { display: none; }
a.figure-zoom.figure-zoomed .figure-zoom-in { display: none; }
a.figure-zoom.figure-zoomed .figure-zoom-out { display: inline-block; }
div.figure > div.inner > div.region > div.contents {
  margin: 0;
  padding: 0.5em 1em 0.5em 1em;
  clear: both;
  text-align: center;
  color: #000000;
  border: solid 1px #c0bfbc;
  background-color: #ffffff;
}
div.list > div.inner > div.title { margin-bottom: 0.5em; }
div.listing > div.inner { margin: 0; padding: 0; }
div.listing > div.inner > div.region > div.desc { font-style: italic; }
div.note {
  padding: 6px;
  border: solid 1px rgb(234,234,233);
  background-color: rgb(244,244,244);
  display: flex;
  flex-flow: row;
}
div.note > * { margin: 0 6px; padding: 0; min-height: 24px; min-width: 24px; }
div.note-warning > svg .yelp-svg-fill {
  fill: #c01c28;
}
div.note-danger {
  border-color: #c01c28;
}
div.note-important > svg .yelp-svg-fill {
  fill: #3584e4;
}
div.note-danger > svg .yelp-svg-fill {
  fill: #c01c28;
  animation-name: yelp-note-danger;
  animation-duration: 2s;
  animation-fill-mode: forwards;
  animation-iteration-count: infinite;
}
@keyframes yelp-note-danger {
  from { fill: #c01c28 }
  50%  { fill: #c0bfbc }
  to   { fill: #c01c28 }
}
div.note-sidebar {
  float: right;
  max-width: 206px;
  margin-left: 20px;
  padding: 6px;
}
div.quote {
  padding: 0;
  min-height: 48px;
}
div.quote > div.inner:before {
  float: left;
  content: '“';
  font-family: "Century Schoolbook L";
  font-size: 48px;
  font-weight: bold;
  line-height: 1em;
  margin: 0; padding: 0;
  height: 48px;
  width: 48px;
  text-align: center;
  color: rgb(234,234,233);
}
div.quote > div.inner > div.title {
  margin: 0;
  margin-left: 48px;
}
blockquote {
  margin: 0; padding: 0;
  margin-left: 48px;
}
blockquote > *:first-child { margin-top: 0; }
div.quote > div.inner > div.region > div.cite {
  margin-top: 0.5em;
  margin-left: 48px;
  color: rgb(102,102,100);
}
div.quote > div.inner > div.region > div.cite::before {
  
  content: '― ';
  color: rgb(102,102,100);
}
div.screen {
  background-color: rgb(244,244,244);
  border: solid 1px #c0bfbc;
}
ol.steps, ul.steps {
  padding: 0.5em 1em 0.5em 1em;
  border-left: solid 4px #f8e45c;
  box-shadow: 0 1px 2px #c0bfbc;
}
ol.steps .steps {
  padding: 0;
  border: none;
  background-color: unset;
  box-shadow: none;
}
li.steps { margin-left: 1.44em; }
li.steps li.steps { margin-left: 2.4em; }
div.synopsis > div.inner > div.region > div.contents,
div.synopsis > div.contents, div.synopsis > pre.contents {
  padding: 0.5em 1em 0.5em 1em;
  border-top: solid 1px;
  border-bottom: solid 1px;
  border-color: rgb(43,107,185);
  background-color: rgb(244,244,244);
}
div.synopsis > div.inner > div.region > div.desc { font-style: italic; }
div.synopsis div.code {
  background: unset;
  border: none;
  padding: 0;
}
div.synopsis div.code > pre.contents { margin: 0; padding: 0; }
div.unknown > div.inner > div.region > div.desc { font-style: italic; }
div.table > div.desc { font-style: italic; }
tr.shade {
  background-color: rgb(244,244,244);
}
td.shade {
  background-color: rgb(244,244,244);
}
tr.shade td.shade {
  background-color: rgb(234,234,233);
}

span.app { font-style: italic; }
span.cmd {
  font-family: monospace,monospace; font-size: 0.83em;
  background-color: rgb(244,244,244);
  padding: 0 0.2em 0 0.2em;
}
span.cmd span.cmd { background-color: unset; padding: 0; }
pre span.cmd { background-color: unset; padding: 0; }
span.code {
  font-family: monospace,monospace; font-size: 0.83em;
  border-bottom: solid 1px rgb(234,234,233);
}
span.code span.code { border: none; }
pre span.code { border: none; }
span.em { font-style: italic; }
span.em-bold {
  font-style: normal; font-weight: bold;
  color: rgb(75,75,73);
}
pre span.error {
  color: rgb(173,25,36);
}
span.file { font-family: monospace,monospace; font-size: 0.83em; }
span.gui, span.guiseq { color: rgb(75,75,73); }
span.input { font-family: monospace,monospace; font-size: 0.83em; }
pre span.input {
  font-weight: bold;
  color: rgb(75,75,73);
}
kbd {
  font-family: inherit;
  font-size: inherit;
  color: rgb(75,75,73);
  background-color: rgb(244,244,244);
  border: solid 1px #c0bfbc;
  border-radius: 2px;
  box-shadow: 1px 1px 2px #c0bfbc;
  margin: 0 0.2em 0 0.2em;
  padding: 0.2em 0.5em 0 0.5em;
  white-space: nowrap;
}
kbd.key-Fn {
  font-weight: bold;
  color: rgb(43,107,185);
}
span.key a {
  border-bottom: none;
}
a > kbd {
  color: rgb(43,107,185);
  border-color: rgb(43,107,185);
}
span.keyseq {
  color: rgb(75,75,73);
  white-space: nowrap
}
span.output { font-family: monospace,monospace; font-size: 0.83em; }
pre span.output {
  color: #000000;
}
pre span.prompt {
  color: rgb(75,75,73);
}
span.sys { font-family: monospace,monospace; font-size: 0.83em; }
span.var { font-style: italic; }

.ui-tile-img .media-controls { display: none; }
span.media-audio, span.media-video { display: inline-block; }
audio, video { display: block; margin: 0; }
div.media > div.inner { display: inline-block; text-align: center; }
.media-controls {
  min-width: 24em;
  height: 24px;
  margin: 0; padding: 0;
  border-left: solid 1px #000000;
  border-right: solid 1px #000000;
  border-bottom: solid 1px #000000;
  background-color: rgb(75,75,73);
  color: #ffffff;
  border-bottom-left-radius: 4px;
  border-bottom-right-radius: 4px;
  display: flex;
  align-items: center;
}
.media-audio .media-controls {
  border-top-left-radius: 4px;
  border-top-right-radius: 4px;
}
.media-controls > * {
  flex: 0 1 auto;
}
.media-controls > input.media-range {
  flex: 1 0 auto;
  background-color: rgb(75,75,73);
  margin: 0 10px;
  -webkit-appearance: none;
}
input.media-range::-webkit-slider-runnable-track {
  height: 4px;
  background: rgb(102,102,100);
  border-radius: 2px;
}
input.media-range::-webkit-slider-thumb {
  -webkit-appearance: none;
  height: 16px;
  width: 16px;
  border-radius: 8px;
  background: rgb(234,234,233);
  border: solid 1px rgb(75,75,73);
  margin-top: -6px;
}
input.media-range::-webkit-slider-thumb:hover,
input.media-range::-webkit-slider-thumb:focus {
  background: rgb(244,244,244);
}
input.media-range::-moz-range-track {
  height: 4px;
  background: rgb(102,102,100);
  border-radius: 2px;
}
input.media-range::-moz-range-thumb {
  -webkit-appearance: none;
  height: 16px;
  width: 16px;
  border-radius: 8px;
  background: rgb(234,234,233);
  border: solid 1px rgb(75,75,73);
  margin-top: -6px;
}
.media-controls-audio {
  border-top: solid 1px #000000;
  border-radius: 4px;
}
button.media-play {
  height: 24px;
  padding: 0 2px 0 2px; line-height: 0;
  background-color: rgb(75,75,73);
  border: none;
  border-right: solid 1px #000000;
}
button.media-play:hover, button.media-play:focus {
  background-color: rgb(43,107,185);
}
button.media-play .yelp-svg-fill { fill: rgb(244,244,244); }
button.media-play .media-pause { display: none; }
button.media-play-playing .media-play { display: none; }
button.media-play-playing .media-pause { display: inline; }
.media-time {
  margin: 0;
  font-size: 16px;
  height: 24px;
  line-height: 24px;
}
.media-time > span {
  padding-right: 8px;
}
.media-duration {
  font-size: 12px;
  color: rgb(234,234,233);
  opacity: 0.8;
}
div.media-ttml { margin: 0; padding: 0; }
.media-ttml-pre { white-space: pre; }
.media-ttml-nopre { white-space: normal; }
div.media-ttml-div {
  text-align: left;
  display: none;
  margin: 0; padding: 0;
}
div.media-ttml-p {
  text-align: left;
  display: none;
  margin: 6px auto 0 auto;
  padding: 6px;
  max-width: 24em;
  border: solid 1px rgb(107,99,41);
  background-color: rgb(253,251,233);
  box-shadow: 2px 2px 4px #c0bfbc;
}
div.yelp-data { display: none; }
.ui-expander > div.inner > div.title span.title,
.ui-expander > div.inner > div.hgroup span.title {
  cursor: default;
}
.ui-expander > div.inner > div.title span.title:before,
.ui-expander > div.inner > div.hgroup span.title:before {
  font-weight: bold;
  content: "⌃";
  display: inline-block;
  margin: 0;
  color: rgb(43,107,185);
  transform: translateY(0.2em) rotate(0deg);
  -webkit-transform: translateY(0.2em) rotate(0deg);
  transition: transform 0.2s linear;
  transform-origin: 50% 30%;
  -webkit-transform-origin: 50% 30%;
  -webkit-transition: -webkit-transform 0.2s linear;
  margin: 0 0.2em;
}
.ui-expander-c > div.inner > div.hgroup { border-bottom: none; }
.ui-expander-e > div.inner > div.title span.title:before,
.ui-expander-e > div.inner > div.hgroup span.title:before {
  transform: translateY(0.2em) rotate(180deg);
  -webkit-transform: translateY(0.2em) rotate(180deg);
}
.ui-expander > div.inner > div.title:hover,
.ui-expander > div.inner > div.hgroup:hover * {
  color: rgb(43,107,185);
}
.ui-expander > div.inner > div.hgroup > .subtitle {
  margin-left: 2em;
}
.ui-expander-c > div.inner > div.region {
  display: none;
}
.ui-expander-e > div.inner > div.region {
  animation-name: yelp-ui-expander-e;
  animation-duration: 0.2s;
  animation-fill-mode: forwards;
  transform-origin: 0 0;
}
@keyframes yelp-ui-expander-e {
  from { transform: scaleY(0); }
  to   { transform: scaleY(1); }
}
div.ui-expander-preview > div.inner > div.region {
  transform-origin: 0 0;
  transition: transform 0.2s linear, background-color 0.2s linear;
  animation-name: none;
}
div.ui-expander-preview.ui-expander-c > div.inner {
  max-height: 100px;
  overflow: hidden;
}
div.ui-expander-preview.ui-expander-c > div.inner > div.region {
  display: block;
  transform: scaleY(0.4);
  background-color: rgb(244,244,244);
}
div.ui-expander-preview.ui-expander-c > div.inner > div.region:hover {
  background-color: rgb(241,246,253);
  cursor: zoom-in;
}
div.ui-expander-preview.ui-expander-c > div.inner > div.region:hover * {
  cursor: zoom-in;
}
div.ui-expander-preview > div.inner > div.region > * {
  transform-origin: 0 0;
  transition: transform 0.2s linear;
}
div.ui-expander-preview.ui-expander-c > div.inner > div.region > * {
  transform: scaleX(0.4);
}
section.ui-expander-preview > div.inner > div.region > div.contents{
  transform-origin: 0 0;
  transition: transform 0.2s linear, background-color 0.2s linear;
}
section.ui-expander-preview.ui-expander-c > div.inner {
  max-height: 140px;
  overflow: hidden;
}
section.ui-expander-preview.ui-expander-c > div.inner > div.region {
  display: block;
}
section.ui-expander-preview.ui-expander-c > div.inner > div.region > div.contents {
  transform: scaleY(0.6);
  background-color: rgb(244,244,244);
}
section.ui-expander-preview > div.inner > div.region > div.contents > * {
  transform-origin: 0 0;
  transition: transform 0.2s linear;
}
section.ui-expander-preview.ui-expander-c > div.inner > div.region > div.contents > * {
  transform: scaleX(0.6);
}
section.ui-expander-preview.ui-expander-c > div.inner > div.region > div.contents:hover {
  background-color: rgb(241,246,253);
  cursor: zoom-in;
}
@media only screen and (max-width: 480px) {
  article > div.region > div.contents > div.example,
  article > div.region > section > div.inner > div.region > div.contents > div.example {
    margin-left: -10px;
    margin-right: -10px;
  }
  div.example {
    padding-left: 6px;
    padding-right: 10px;
  }
  article > div.region > div.contents > div.note,
  article > div.region > section > div.inner > div.region > div.contents > div.note {
    margin-left: -10px;
    margin-right: -10px;
    padding-left: 10px;
    padding-right: 10px;
  }
  article > div.region > div.contents > div.note,
  article > div.region > section > div.inner > div.region > div.contents > div.note {
    border-left: none;
    border-right: none;
  }
  div.note-sidebar {
    float: none;
    max-width: none;
    margin-left: inherit;
    margin-right: inherit;
    padding-left: inherit;
    padding-right: inherit;
  }
  div.note-sidebar > div.inner > div.title,
  div.note-sidebar > div.inner > div.region > div.contents {
    margin-left: 10px;
    margin-right: 10px;
  }
  article > div.region > div.contents > div.steps,
  article > div.region > section > div.inner > div.region > div.contents > div.steps {
    margin-left: -10px;
    margin-right: -10px;
  }
  div.steps > div.inner > div.title {
    margin-left: 10px;
    margin-right: 10px;
  }
  ol.steps, ul.steps {
    box-shadow: none;
    padding: 0;
    padding-left: 6px;
    padding-right: 10px;
  }
}

.hljs a {
  color: inherit;
  border-bottom: dotted 1px rgb(43,107,185);
}
.hljs a:hover, .hljs a:hover * { color: rgb(43,107,185); }
.hljs-addition {
  color: rgb(46,121,73);
  background-color: rgb(227,250,236);
}
.hljs-deletion {
  color: rgb(173,25,36);
  background-color: rgb(251,243,244);
}
.hljs-emphasis  { font-style: italic; }
.hljs-strong    { font-weight: bold; }
.hljs-attr      { color: rgb(43,107,185); }
.hljs-attribute { color: rgb(107,99,41); }
.hljs-built_in  { color: rgb(150,96,43); }
.hljs-bullet    { color: rgb(46,121,73); }
.hljs-class     { }
.hljs-code      { }
.hljs-comment   { color: rgb(102,102,100); }
.hljs-doctag    { }
.hljs-formula   { color: rgb(75,75,73); }
.hljs-function  { }
.hljs-keyword   { color: rgb(147,64,167); }
.hljs-link      { color: rgb(150,96,43); }
.hljs-literal   { color: rgb(150,96,43); }
.hljs-meta      { color: rgb(150,96,43); }
.hljs-name      { color: rgb(173,25,36); }
.hljs-number    { color: rgb(150,96,43); }
.hljs-params    { color: rgb(150,96,43); }
.hljs-quote     { color: rgb(102,102,100); }
.hljs-regexp    { color: rgb(173,25,36); }
.hljs-rest_arg  { }
.hljs-section   { color: rgb(43,107,185); }
.hljs-string    { color: rgb(46,121,73); }
.hljs-subst     { }
.hljs-symbol    { color: rgb(46,121,73); }
.hljs-tag       { color: rgb(173,25,36); }
.hljs-title     { color: rgb(43,107,185); }
.hljs-type      { }
.hljs-variable  { }
.hljs-selector-attr  { }
.hljs-selector-class { color: rgb(173,25,36); }
.hljs-selector-id    { color: rgb(173,25,36); }
.hljs-selector-tag   { color: rgb(147,64,167); }
.hljs-template-tag      { }
.hljs-template-variable { }

div.hgroup.bridgehead { margin-top: 1em; }


sub { font-size: 0.83em; }
sub sub { font-size: 1em; }
sup { font-size: 0.83em; }
sup sup { font-size: 1em; }
table.table-pgwide { width: 100%; }
table.table-rules-groups thead + *, table.table-rules-rows thead + *,
table.table-rules-groups tfoot + *, table.table-rules-rows tfoot + *,
table.table-rules-groups tbody + *, table.table-rules-rows tbody + *,
table.table-rules-rows tr + * { border-top: solid 1px; }
table.table-rules-cols td + *, table.table-rules-cols th + * {
  border-left: solid 1px;
}

td.td-colsep { border-right: solid 1px; }
td.td-rowsep { border-bottom: solid 1px; }


span.bibliolabel {
  font-weight: bold;
  color: rgb(75,75,73);
}
div.biblioentry span.title {
  font-weight: normal;
  font-style: italic;
}
span.citetitle {
  font-style: italic;
}


div.epigraph {
  text-align: right;
  margin-left: 20%;
  margin-right: 0;
  color: rgb(75,75,73);
}
div.programlisting .userinput {
  font-weight: bold;
  color: rgb(75,75,73);
}
div.address, div.literallayout { white-space: pre; }



div.footnotes {
  border-top: solid 2px #c0bfbc;
}
div.footnote { margin-top: 1.44em; }
sup.footnote { font-size: 0.83em; }
a.footnote {
  font-weight: bold;
  text-decoration: none;
  border-bottom: none;
  padding: 0.2em 0.5em 0.2em 0.5em;
  border-radius: 2px;
}
div.footnote > a.footnote {
  margin-right: 0.83em;
  background-color: rgb(244,244,244);
}
div.footnote > a.footnote + p { display: inline-block; margin: 0; }
a.footnote:hover, div.footnote > a.footnote:hover {
  background-color: rgb(241,246,253);
  box-shadow: 0 0 2px #3584e4;
}


dt.ixprimary {
  font-weight: bold;
  color: rgb(75,75,73);
}
dt.ixprimary * { font-style: normal; }
dt.ixprimary + dt.ixprimary { margin-top: 1em; }
dd.ixsecondary {
  color: rgb(102,102,100);
}
dt.ixsecondary, dt.ixtertiary { margin-top: 0.2em; }
dd.ixlink, dd.ixsee, dd.ixseealso {
  color: rgb(102,102,100);
}
dd.ixlink + dd, dd.ixsee + dd, dd.ixseealso + dd {
  margin-top: 0.2em;
}
dt.ixsecondary:before, dt.ixtertiary:before {
  content: "⏺";
  color: rgb(102,102,100);
}
dd.ixlink:before {
  content: "⏺";
  color: #3584e4;
}
dd.ixsee:before, dd.ixseealso:before {
  content: "⏺";
  color: #c0bfbc;
}


dl.index dt { margin-top: 0; }
dl.index dd { margin-top: 0; margin-bottom: 0; }
dl.indexdiv dt { margin-top: 0; }
dl.indexdiv dd { margin-top: 0; margin-bottom: 0; }
dl.setindex dt { margin-top: 0; }
dl.setindex dd { margin-top: 0; margin-bottom: 0; }
div.simplelist { margin-left: 1.72em; }
div.simplelist table { margin-left: 0; border: none; }
div.simplelist td {
  padding: 0.5em;
  border-left: solid 1px #c0bfbc;
}
div.simplelist td:first-child {
  padding-left: 0;
  border-left: 0;
}

span.accel { text-decoration: underline; }
span.email { font-family: monospace,monospace; font-size: 0.83em; }
span.firstterm { font-style: italic; }
span.foreignphrase { font-style: italic; }

dt.glossterm span.glossterm { font-style: normal; }


span.glossterm { font-style: italic; }

span.lineannotation { font-style: italic; }
span.medialabel { font-style: italic; }
.methodparam span.parameter { font-style: italic; }
span.paramdef span.parameter { font-style: italic; }
span.prompt { font-family: monospace,monospace; font-size: 0.83em; }
span.wordasword { font-style: italic; }


dt.question {
  margin-left: 0;
  margin-right: 0;
  font-weight: bold;
  color: rgb(75,75,73);
}
dd + dt.question { margin-top: 1em; }
dd.answer {
  margin-top: 1em;
  margin-left: 2em;
  margin-right: 2em;
}
div.qanda-label {
  line-height: 1.44em;
  float: left;
  margin-right: 1em;
  font-weight: bold;
  color: rgb(75,75,73);
}
dl.qandaset ol, dl.qandaset ul, dl.qandaset table { clear: both; }

div.synopfragment { padding-top: 0.5em; }
span.co {
  border-radius: 4px;
  background-color: rgb(253,251,233);
  outline: solid 1px #f8e45c;
}
span.co a { text-decoration: none; }
span.co a:hover { text-decoration: none; }
div.co {
  margin: 0;
  float: left;
  clear: both;
}
</style>
<script type="text/javascript" src="highlight.pack.js"></script><script>
document.addEventListener('DOMContentLoaded', function() {
  var matches = document.querySelectorAll('code.syntax')
  for (var i = 0; i < matches.length; i++) {
    hljs.highlightBlock(matches[i]);
  }
}, false);</script><script type="text/javascript">
document.addEventListener('DOMContentLoaded', function() {
  var yelp_hash_highlight = function () {
    if (location.hash != '') {
      var sect = document.querySelector(location.hash);
      if (sect != null) {
        sect.classList.add('yelp-hash-highlight');
        window.setTimeout(function () {
          sect.classList.remove('yelp-hash-highlight');
        }, 500);
      }
    }
  }
  window.addEventListener('hashchange', yelp_hash_highlight, false);
  yelp_hash_highlight();
}, false);

var __yelp_generate_id_counter__ = 0;
function yelp_generate_id () {
  var ret = 'yelp--' + (++__yelp_generate_id_counter__).toString();
  if (document.getElementById(ret) != null)
    return yelp_generate_id();
  else
    return ret;
};
function yelp_ui_expander_init (expander) {
  var yelpdata = null;
  var innerdiv = null;
  var region = null;
  var contents = null;
  var title = null;
  var title_e = null;
  var title_c = null;
  var titlespan = null;
  var issect = false;
  for (var i = 0; i < expander.children.length; i++) {
    var child = expander.children[i];
    if (child.classList.contains('yelp-data-ui-expander')) {
      yelpdata = child;
    }
    else if (child.classList.contains('inner')) {
      innerdiv = child;
    }
  }
  if (innerdiv == null) {
    return;
  }
  for (var i = 0; i < innerdiv.children.length; i++) {
    var child = innerdiv.children[i];
    if (child.classList.contains('region')) {
      region = child;
    }
    else if (child.classList.contains('title')) {
      title = child;
    }
    else if (child.classList.contains('hgroup')) {
      title = child;
      issect = true;
    }
  }
  if (region == null || title == null) {
    return;
  }
  if (!region.hasAttribute('id')) {
    region.setAttribute('id', yelp_generate_id());
  }
  title.setAttribute('aria-controls', region.getAttribute('id'));

  if (yelpdata != null) {
    for (var i = 0; i < yelpdata.children.length; i++) {
      var child = yelpdata.children[i];
      if (child.classList.contains('yelp-title-expanded')) {
        title_e = child;
      }
      else if (child.classList.contains('yelp-title-collapsed')) {
        title_c = child;
      }
    }
  }
  titlespan = title.querySelector('span.title');
  if (titlespan == null) {
    return;
  }
  if (title_e == null) {
    var node = document.createElement('div');
    node.className = 'yelp-title-expanded';
    node.innerHTML = titlespan.innerHTML;
    yelpdata.appendChild(node);
    title_e = node;
  }
  if (title_c == null) {
    var node = document.createElement('div');
    node.className = 'yelp-title-collapsed';
    node.innerHTML = titlespan.innerHTML;
    yelpdata.appendChild(node);
    title_c = node;
  }

  var ui_expander_zoom_region = function (event) {
    if (yelpdata.getAttribute('data-yelp-expanded') != 'false') {
      ui_expander_toggle();
      event.preventDefault();
    }
  }
  if (expander.nodeName == 'section' || expander.nodeName == 'SECTION') {
    for (var i = 0; i < region.children.length; i++) {
      var child = region.children[i];
      if (child.classList.contains('contents')) {
        contents = child;
        break;
      }
    }
    contents.addEventListener('click', ui_expander_zoom_region, true);
  }
  else {
    region.addEventListener('click', ui_expander_zoom_region, true);
  }

  var ui_expander_toggle = function () {
    if (yelpdata.getAttribute('data-yelp-expanded') == 'false') {
      yelpdata.setAttribute('data-yelp-expanded', 'true');
      expander.classList.remove('ui-expander-e');
      expander.classList.add('ui-expander-c');
      region.setAttribute('aria-expanded', 'false');
      if (title_c != null)
        titlespan.innerHTML = title_c.innerHTML;
    }
    else {
      yelpdata.setAttribute('data-yelp-expanded', 'false');
      expander.classList.remove('ui-expander-c');
      expander.classList.add('ui-expander-e');
      region.setAttribute('aria-expanded', 'true');
      if (title_e != null)
        titlespan.innerHTML = title_e.innerHTML;
    }
  };
  expander.yelp_ui_expander_toggle = ui_expander_toggle;
  title.addEventListener('click', ui_expander_toggle, false);
  ui_expander_toggle();
}
document.addEventListener('DOMContentLoaded', function() {
  var matches = document.querySelectorAll('.ui-expander');
  for (var i = 0; i < matches.length; i++) {
    yelp_ui_expander_init(matches[i]);
  }
  var yelp_hash_ui_expand = function () {
    if (location.hash != '') {
      var sect = document.querySelector(location.hash);
      if (sect != null) {
        for (var cur = sect; cur instanceof Element; cur = cur.parentNode) {
          if (cur.classList.contains('ui-expander')) {
            if (cur.classList.contains('ui-expander-c')) {
              cur.yelp_ui_expander_toggle();
            }
          }
        }
        sect.scrollIntoView();
      }
    }
  };
  window.addEventListener('hashchange', yelp_hash_ui_expand, false);
  yelp_hash_ui_expand();
}, false);

yelp_color_text_light = 'rgb(75,75,73)';
yelp_color_gray_background = 'rgb(244,244,244)';
yelp_color_gray_border = '#c0bfbc';
function yelp_figure_init (figure) {
  var zoom = figure.querySelector('a.figure-zoom');

  var figure_resize = function () {
    var zoomed = zoom.classList.contains('figure-zoomed');
    var imgs = figure.querySelectorAll('img');
    for (var i = 0; i < imgs.length; i++) {
      var img = imgs[i];
      var mediaDiv = null;
      for (var cur = img; cur instanceof Element; cur = cur.parentNode) {
        if ((cur.nodeName == 'div' || cur.nodeName == 'DIV') &&
            cur.classList.contains('media')) {
          mediaDiv = cur;
          break;
        }
      }
      if (mediaDiv == null)
        continue;
      if (!img.hasAttribute('data-yelp-original-width')) {
        var iwidth = null;
        if (img.hasAttribute('width'))
          iwidth = parseInt(img.getAttribute('width'));
        else
          iwidth = img.width;
        img.setAttribute('data-yelp-original-width', iwidth);
        var iheight = null;
        if (img.hasAttribute('height'))
          iheight = parseInt(img.getAttribute('height'));
        else
          iheight = img.height * (iwidth / img.width);
        img.setAttribute('data-yelp-original-height', iheight);
      }
      var owidth = img.width;
      var oheight = img.height;
      img.width = parseInt(img.getAttribute('data-yelp-original-width'));
      img.height = parseInt(img.getAttribute('data-yelp-original-height'));
      var mediaw = mediaDiv.offsetWidth;
      img.width = owidth;
      img.height = oheight;
      if (parseInt(img.getAttribute('data-yelp-original-width')) <= mediaw) {
        img.width = parseInt(img.getAttribute('data-yelp-original-width'));
        img.height = parseInt(img.getAttribute('data-yelp-original-height'));
        zoom.style.display = 'none';
      }
      else if (zoomed) {
        img.width = parseInt(img.getAttribute('data-yelp-original-width'));
        img.height = parseInt(img.getAttribute('data-yelp-original-height'));
        zoom.style.display = 'block';
      }
      else {
        img.width = mediaw;
        img.height = (parseInt(img.getAttribute('data-yelp-original-height')) *
                      img.width /
                      parseInt(img.getAttribute('data-yelp-original-width')));
        zoom.style.display = 'block';
      }
    }
  }
  figure.yelp_figure_resize = figure_resize;
  figure.yelp_figure_resize();

  zoom.onclick = function (e) {
    var zoomed = zoom.classList.contains('figure-zoomed');
    if (zoomed)
      zoom.classList.remove('figure-zoomed');
    else
      zoom.classList.add('figure-zoomed');
    figure.yelp_figure_resize();
    return false;
  };
}
window.addEventListener('load', function() {
  var figures = document.querySelectorAll('div.figure');
  for (var i = 0; i < figures.length; i++) {
    if (figures[i].querySelector('img') != null)
      yelp_figure_init(figures[i]);
  }
  var timeout = null;
  var yelp_figures_resize = function () {
    if (timeout != null)
      return;
    timeout = window.setTimeout(function () {
      for (var i = 0; i < figures.length; i++) {
        if (figures[i].querySelector('img') != null)
          figures[i].yelp_figure_resize();
      }
      window.clearTimeout(timeout);
      timeout = null;
    }, 100);
  };
  window.addEventListener('resize', yelp_figures_resize, false);
}, false);
function yelp_media_init (media) {
  media.removeAttribute('controls');
  if (media.parentNode.classList.contains('links-tile-img')) {
    return;
  }

  media.addEventListener('click', function () {
    if (media.paused)
      media.play();
    else
      media.pause();
  }, false);

  var controls = null;
  for (var cur = media.nextSibling; cur instanceof Element; cur = cur.nextSibling) {
    if (cur.classList.contains('media-controls')) {
      controls = cur;
      break;
    }
  }
  if (controls == null) {
    media.setAttribute('controls', 'controls');
    return;
  }
  var playbutton = controls.querySelector('button.media-play');
  playbutton.addEventListener('click', function () {
    if (media.paused || media.ended)
      media.play();
    else
      media.pause();
  }, false);

  var mediachange = function () {
    if (media.ended)
      media.pause()
    if (media.paused) {
      playbutton.setAttribute('value', playbutton.getAttribute('data-play-label'));
      playbutton.classList.remove('media-play-playing');
    }
    else {
      playbutton.setAttribute('value', playbutton.getAttribute('data-pause-label'));
      playbutton.classList.add('media-play-playing');
    }
  }
  media.addEventListener('play', mediachange, false);
  media.addEventListener('pause', mediachange, false);
  media.addEventListener('ended', mediachange, false);

  var mediarange = controls.querySelector('input.media-range');
  mediarange.addEventListener('input', function () {
    var pct = this.value;
    if (pct < 0)
      pct = 0;
    if (pct > 100)
      pct = 100;
    media.currentTime = (pct / 100.0) * media.duration;
  }, false);
  var curspan = controls.querySelector('span.media-current');
  var durspan = controls.querySelector('span.media-duration');
  var durationUpdate = function () {
    if (!isNaN(media.duration)) {
      mins = parseInt(media.duration / 60);
      secs = parseInt(media.duration - (60 * mins));
      durspan.textContent = (mins + (secs < 10 ? ':0' : ':') + secs);
    }
  };
  media.addEventListener('durationchange', durationUpdate, false);

  var ttmlDiv = null;
  var ttmlNodes = null;
  for (var i = 0; i < media.parentNode.children.length; i++) {
    var child = media.parentNode.children[i];
    if (child.classList.contains('media-ttml'))
      ttmlDiv = child;
  }
  if (ttmlDiv != null) {
    ttmlNodes = ttmlDiv.querySelectorAll('.media-ttml-node');
  }

  var timeUpdate = function () {
    var pct = (media.currentTime / media.duration) * 100;
    mediarange.value = pct;
    var mins = parseInt(media.currentTime / 60);
    var secs = parseInt(media.currentTime - (60 * mins))
    curspan.textContent = (mins + (secs < 10 ? ':0' : ':') + secs);
    if (ttmlNodes != null) {
      for (var i = 0; i < ttmlNodes.length; i++) {
        var ttml = ttmlNodes[i];
        if (media.currentTime >= parseFloat(ttml.getAttribute('data-ttml-begin')) &&
            (!ttml.hasAttribute('data-ttml-end') ||
             media.currentTime < parseFloat(ttml.getAttribute('data-ttml-end')) )) {
          if (ttml.tagName == 'span' || ttml.tagName == 'SPAN')
            ttml.style.display = 'inline';
          else
            ttml.style.display = 'block';
        }
        else {
          ttml.style.display = 'none';
        }
      }
    }
  };
  media.addEventListener('timeupdate', timeUpdate, false);
};
document.addEventListener('DOMContentLoaded', function() {
  var matches = document.querySelectorAll('video, audio');
  for (var i = 0; i < matches.length; i++) {
    yelp_media_init(matches[i]);
  }
}, false);
</script>
</head>
<body><main><div class="page">
<header><div class="inner pagewide"><div class="trails" role="navigation"><div class="trail">
<a class="trail" href="index.html" title="StarDict Manual V4.0.0">StarDict Manual V4.0.0</a> » </div></div></div></header><article><nav class="prevnext pagewide"><div class="inner">
<a href="manage-plugins.html" title="Manage Plugins">Previous</a><a href="stardict-portable.html" title="StarDict Portable">Next</a>
</div></nav><div class="hgroup pagewide"><h1 class="title">Details</h1></div>
<div class="region">
<div class="contents pagewide"><div class="links sectionlinks" role="navigation"><ul>
<li class="links"><a class="xref" href="stardict-details.html#stardict-details-command-line" title="Command line options">Command line options</a></li>
<li class="links"><a class="xref" href="stardict-details.html#stardict-details-dictmanage" title="Dictionary Management">Dictionary Management</a></li>
<li class="links"><a class="xref" href="stardict-details.html#stardict-details-help" title="Help">Help</a></li>
<li class="links"><a class="xref" href="stardict-details.html#stardict-details-dirs" title="StarDict directories">StarDict directories</a></li>
<li class="links"><a class="xref" href="stardict-details.html#stardict-details-logging" title="Logging">Logging</a></li>
<li class="links"><a class="xref" href="stardict-details.html#stardict-details-GUI-lang" title="Interface language">Interface language</a></li>
<li class="links"><a class="xref" href="stardict-details.html#stardict-details-dictionaries" title="StarDict dictionaries">StarDict dictionaries</a></li>
</ul></div></div>
<section id="stardict-details-command-line" class="sect2"><div class="inner">
<div class="hgroup pagewide"><h2 class="title">Command line options</h2></div>
<div class="region"><div class="contents pagewide">
<p class="para"><span class="app application">StarDict</span> usage:
	</p>
<p class="para"><span class="cmd command">stardict <span class="var replaceable">options</span> <span class="var replaceable">query_word</span></span>
	</p>
<div class="terms variablelist"><div class="inner"><div class="region"><div class="contents"><dl class="terms variablelist">
<dt class="terms">query_word</dt>
<dd class="terms">
		<p class="para">With <span class="var replaceable">query_word</span> you request <span class="app application">StarDict</span> to look up the specified word just after startup. It has the same effect as if you had typed that word in the Search field. You may use pattens, fuzzy query and other supported modes.
		</p>
		</dd>
<dt class="terms">-m, --message-level=<span class="var replaceable">integer</span>
</dt>
<dd class="terms">
		<p class="para">This option specifies the minimum severity level of message that should be printed on console. The value may range from 0 to 6, where 0 means to suppress all output, 6 ‒ print all produced messages, including debug ones. Default value is 4 which passes informational messages, like what dictionaries are loaded during startup.
		</p>
		</dd>
<dt class="terms">-l, --log-level=<span class="var replaceable">integer</span>
</dt>
<dd class="terms">
		<p class="para">This option specifies the minimum severity level of message that should be logged. The value may range from 0 to 6, where 0 means to suppress all output, 6 ‒ print all produced messages, including debug ones. Default value is 0, that is log file is not used. See <a class="xref" href="stardict-details.html#stardict-details-logging" title="Logging">Logging</a> for details about <span class="app application">StarDict</span> log.
		</p>
		</dd>
<dt class="terms">-h, --hide</dt>
<dd class="terms">
		<p class="para">Do not show splash screen during startup and hide the Main window. Only notification area icon will be visible.
		</p>
		</dd>
<dt class="terms">-n, --new</dt>
<dd class="terms">
		<p class="para">Start a new instance of <span class="app application">StarDict</span>.
		By default <span class="app application">StarDict</span> checks if the application is already running and prevents starting the second instance.
		</p>
		<p class="para">This option is only available in Windows edition and Gnome edition of <span class="app application">StarDict</span>.
		</p>
		</dd>
<dt class="terms">-q, --quit</dt>
<dd class="terms">
		<p class="para">Quit an existing instance of <span class="app application">StarDict</span>.
		</p>
		<p class="para">This option is only available in Gnome edition of <span class="app application">StarDict</span>.
		</p>
		</dd>
<dt class="terms">--dirs-config</dt>
<dd class="terms">
		<p class="para">Specifies path to the <span class="app application">StarDict</span> directory configuration file. See <a class="xref" href="stardict-details.html#stardict-details-dirs" title="StarDict directories">StarDict directories</a> for details about <span class="app application">StarDict</span> directories and configuration file.
		</p>
		<p class="para">This option is only available in Windows edition of <span class="app application">StarDict</span>.
		</p>
		</dd>
<dt class="terms">--portable-mode</dt>
<dd class="terms">
		<p class="para">Activate portable mode, see <a class="xref" href="stardict-portable.html" title="StarDict Portable">StarDict Portable</a>. Specifying the option is not enough to make <span class="app application">StarDict</span> to be <span class="app application">StarDict Portable</span>. You should avoid using this option unless you know what you are doing.
		</p>
		<p class="para">This option is only available in Windows edition of <span class="app application">StarDict</span>.
		</p>
		</dd>
</dl></div></div></div></div>
</div></div>
</div></section><section id="stardict-details-dictmanage" class="sect2"><div class="inner">
<div class="hgroup pagewide"><h2 class="title">Dictionary Management</h2></div>
<div class="region"><div class="contents pagewide">
<p class="para">To manage the dictionaries, click the <span class="gui guibutton">Manage dictionaries</span> button at the bottom-right corner of the Main window, or click 
	the <span class="gui guibutton">Main menu</span> button and choose <span class="gui guimenuitem">Dict manage</span>. 
	</p>
<p class="para">In the dictionary management dialog, you can disable dictionaries that you don't need, 
	and you can set the order in which the dictonaries are queried. 
	</p>
<p class="para"><span class="app application">StarDict</span> will search the dictionary files at "~/.stardict/dic" and "/usr/share/stardict/dic", and 
	search tree dictionary files at "~/.stardict/treedict" and "/usr/share/stardict/treedict"</p>
</div></div>
</div></section><section id="stardict-details-help" class="sect2"><div class="inner">
<div class="hgroup pagewide"><h2 class="title">Help</h2></div>
<div class="region"><div class="contents pagewide">
<p class="para">Inside <span class="app application">StarDict</span> you may open documentation either by pressing the <span class="keyseq keycombo"><span class="key keycap"><kbd>F1</kbd></span></span> key or by clicking the <span class="gui guibutton">Main menu</span> button, then the <span class="gui guimenuitem">Help</span> item in the popup menu. <span class="app application">StarDict</span> documentation has different formats depending on application edition. The primary documentation format is DocBook. <span class="app application">StarDict</span> installs documentation in DocBook format only in Gnome edition. In this edition documentation seamlessly integrates with Gnome documentation system. It can be read through <span class="app application">Help Browser</span>. Documentation was translated into a number of languages. You are presented with localized version if it's available. Gnome allows to configure the prefered language.
	</p>
<p class="para">In other editions of <span class="app application">StarDict</span> documentation is available in html format. You need to configure Web browser to view documentation, see <a class="xref" href="stardict-prefs.html#stardict-prefs-network-web-browser" title="Web browser">Web browser</a>. Choosing documentation language, <span class="app application">StarDict</span> roughly follows gettext package locale selection algorithm. The LANGUAGE enviroment variable is checked first. It's expected to contain a list of language codes in the order of preference. If the LANGUAGE variable is not set, the current locale is inspected. Finally, if documentation in prefered languages is not available, the english documentation is shown.
	</p>
<p class="para">
	In Windows edition of <span class="app application">StarDict</span> the default language corresponds to the language selected in the <span class="gui guilabel">Regional and Language Options</span> dialog. 
	</p>
<div class="note note-tip" title="Tip">
<svg height="24" width="24" version="1.1">
 <g>
  <path class="yelp-svg-fill" style="color-rendering:auto;text-decoration-color:#000000;color:#000000;isolation:auto;mix-blend-mode:normal;shape-rendering:auto;solid-color:#000000;block-progression:tb;text-decoration-line:none;text-decoration-style:solid;image-rendering:auto;white-space:normal;text-indent:0;text-transform:none" d="m12 2c-3.8541 0-7 3.1459-7 7 0 1.823 0.4945 3.139 1.1641 4.133 0.6695 0.994 1.4328 1.671 2.039 2.471 0.0882 0.116 0.1749 0.656 0.2071 1.32 0.016 0.332 0.0133 0.68 0.1894 1.119 0.0881 0.22 0.2439 0.478 0.5059 0.672 0.2619 0.194 0.6028 0.285 0.8945 0.285h4c0.583 0 1.204-0.478 1.402-0.908 0.199-0.43 0.217-0.793 0.244-1.137 0.056-0.688 0.138-1.319 0.211-1.441 0.549-0.916 1.304-2.009 1.94-3.114 0.636-1.104 1.203-2.199 1.203-3.4 0-3.8541-3.146-7-7-7zm0 2c2.773 0 5 2.2267 5 5 0 0.456-0.359 1.401-0.936 2.402-0.111 0.195-0.246 0.399-0.369 0.598h-7.8825c-0.4871-0.728-0.8125-1.519-0.8125-3 0-2.7733 2.2267-5 5-5z"></path>
  <path class="yelp-svg-fill" d="m9 20a0.5 0.5 0 0 0 -0.5 0.5 0.5 0.5 0 0 0 0.5 0.5h6a0.5 0.5 0 0 0 0.5 -0.5 0.5 0.5 0 0 0 -0.5 -0.5h-6zm0 2a0.5 0.5 0 0 0 -0.5 0.5 0.5 0.5 0 0 0 0.5 0.5h6a0.5 0.5 0 0 0 0.5 -0.5 0.5 0.5 0 0 0 -0.5 -0.5h-6z"></path>
 </g>
</svg><div class="inner">
<div class="title"><h3><span class="title">Changing default language</span></h3></div>
<div class="region"><div class="contents">
	
	<p class="para">Open <span class="gui guilabel">Control Panel</span>, <span class="gui guilabel">Regional and Language Options</span>.
	<span class="gui guilabel">Regional and Language Options</span> dialog pops up. On the <span class="gui guilabel">Regional Options</span> tab select a language in the <span class="gui guilabel">Stardards and formats</span> group.
	</p>
	</div></div>
</div>
</div>
<p class="para">
	You may override the default language with the LANGUAGE environment variable. 
	</p>
<p class="para">
	Normally, help files can be found in the <span class="file filename">C:\Program Files\StarDict\help</span> directory. Each directory corresponds to one language. Directories are named after language codes.
	</p>
</div></div>
</div></section><section id="stardict-details-dirs" class="sect2"><div class="inner">
<div class="hgroup pagewide"><h2 class="title">StarDict directories</h2></div>
<div class="region"><div class="contents pagewide">
<p class="para"><span class="app application">StarDict</span> uses a number of directories to store application data, load and save configuration settings.
	Default directories are assigned at build time, but some of them 
	can be overriden with <span class="file filename">stardict-dirs.cfg</span> file.
	Overriding StarDict directories is useful for debugging,
	preparing special configurations like StarDict-portable for Windows,
	an ordinary user does not need this.
	</p>
<p class="para">
	<span class="app application">StarDict</span> searches for the <span class="file filename">stardict-dirs.cfg</span> file in the <span class="code varname">user_config_dir</span> directory. You may override location of the <span class="file filename">stardict-dirs.cfg</span> file with <span class="code varname">STARDICT_DIRS_CONFIG_FILE</span> environment variable or with <span class="cmd parameter">--dirs-config</span> command line option. Command line option takes the highest precedence, then the environment variable is inspected, and finally the file in the <span class="code varname">user_config_dir</span> directory. The first specified file wins, it will be probed as a configuration file. If load fails, no other files will be tried.
	</p>
<p class="para">The <span class="file filename">stardict-dirs.cfg</span> file is a .ini-like config file. The syntax of .ini files is described in detail in the <a href="http://freedesktop.org/wiki/Specifications/desktop-entry-spec" class="ulink" title="http://freedesktop.org/wiki/Specifications/desktop-entry-spec">Desktop Entry Specification</a>.
	All keys must belong to <span class="quote">“general”</span> group. 
	</p>
<div class="note note-tip" title="Tip">
<svg height="24" width="24" version="1.1">
 <g>
  <path class="yelp-svg-fill" style="color-rendering:auto;text-decoration-color:#000000;color:#000000;isolation:auto;mix-blend-mode:normal;shape-rendering:auto;solid-color:#000000;block-progression:tb;text-decoration-line:none;text-decoration-style:solid;image-rendering:auto;white-space:normal;text-indent:0;text-transform:none" d="m12 2c-3.8541 0-7 3.1459-7 7 0 1.823 0.4945 3.139 1.1641 4.133 0.6695 0.994 1.4328 1.671 2.039 2.471 0.0882 0.116 0.1749 0.656 0.2071 1.32 0.016 0.332 0.0133 0.68 0.1894 1.119 0.0881 0.22 0.2439 0.478 0.5059 0.672 0.2619 0.194 0.6028 0.285 0.8945 0.285h4c0.583 0 1.204-0.478 1.402-0.908 0.199-0.43 0.217-0.793 0.244-1.137 0.056-0.688 0.138-1.319 0.211-1.441 0.549-0.916 1.304-2.009 1.94-3.114 0.636-1.104 1.203-2.199 1.203-3.4 0-3.8541-3.146-7-7-7zm0 2c2.773 0 5 2.2267 5 5 0 0.456-0.359 1.401-0.936 2.402-0.111 0.195-0.246 0.399-0.369 0.598h-7.8825c-0.4871-0.728-0.8125-1.519-0.8125-3 0-2.7733 2.2267-5 5-5z"></path>
  <path class="yelp-svg-fill" d="m9 20a0.5 0.5 0 0 0 -0.5 0.5 0.5 0.5 0 0 0 0.5 0.5h6a0.5 0.5 0 0 0 0.5 -0.5 0.5 0.5 0 0 0 -0.5 -0.5h-6zm0 2a0.5 0.5 0 0 0 -0.5 0.5 0.5 0.5 0 0 0 0.5 0.5h6a0.5 0.5 0 0 0 0.5 -0.5 0.5 0.5 0 0 0 -0.5 -0.5h-6z"></path>
 </g>
</svg><div class="inner"><div class="region"><div class="contents">
	<p class="para">Do not forget to double backslash characters in values. Backslash is used as path separator in Windows.
	</p>
	</div></div></div>
</div>
<p class="para">Example of <span class="file filename">stardict-dirs.cfg</span> file for Windows:
	<div class="code"><pre class="contents"><code>
[general]
data_dir=C:\\Program Files\\StarDict
dll_dir=C:\\StarDict\\msvc_2008\\Debug
plugin_dir=C:\\StarDict\\msvc_2008\\Debug

	</code></pre></div>
	</p>
<div class="terms variablelist"><div class="inner">
<div class="title"><h3><span class="title">StarDict directories</span></h3></div>
<div class="region"><div class="contents"><dl class="terms variablelist">
<dt class="terms">user_config_dir
		</dt>
<dd class="terms">
		<p class="para">A directory of configuration files.</p>
		<p class="para">Windows default: <span class="file filename">C:\Documents and Settings\%USERNAME%\Application Data\StarDict</span>.
		</p>
		<p class="para">Other default: <span class="file filename">~/.stardict</span>.
		</p>
		<p class="para">Environment variable: <span class="code varname">STARDICT_CONFIG_PATH</span>.
		</p>
		<p class="para"><span class="file filename">stardict-dirs.cfg</span> key: user_config_dir.
		</p>
		</dd>
<dt class="terms">user_cache_dir
		</dt>
<dd class="terms">
		<p class="para">User cache directory.</p>
		<p class="para">Windows default: <span class="file filename">C:\Documents and Settings\%USERNAME%\Temporary Internet Files\stardict</span>.
		</p>
		<p class="para">Other default: <span class="file filename">~/.cache/stardict</span>.
		</p>
		<p class="para"><span class="file filename">stardict-dirs.cfg</span> key: user_cache_dir.
		</p>
		</dd>
<dt class="terms">data_dir
		</dt>
<dd class="terms">
		<p class="para">Data directory.
		</p>
		<p class="para">Windows default: <span class="file filename">C:\Program Files\StarDict</span>.
		</p>
		<p class="para">Other default: <span class="file filename">/usr/share/stardict</span>.
		</p>
		<p class="para"><span class="file filename">stardict-dirs.cfg</span> key: data_dir.
		</p>
		</dd>
<dt class="terms">dll_dir
		</dt>
<dd class="terms">
		<p class="para">A directory of hook dlls, in Windows edition only.
		</p>
		<p class="para">Windows default: <span class="code varname">data_dir</span>.
		</p>
		<p class="para"><span class="file filename">stardict-dirs.cfg</span> key: dll_dir.
		</p>
		</dd>
<dt class="terms">plugin_dir
		</dt>
<dd class="terms">
		<p class="para">A directory of StarDict plugins.
		</p>
		<p class="para">Windows default: <span class="code varname">data_dir</span> + <span class="file filename">"/plugins"</span>.
		</p>
		<p class="para">Other default: <span class="file filename">/usr/lib/stardict/plugins</span>.
		</p>
		<p class="para"><span class="file filename">stardict-dirs.cfg</span> key: plugins_dir.
		</p>
		</dd>
<dt class="terms">help_dir
		</dt>
<dd class="terms">
		<p class="para">A directory of help files, in all editions except Gnome edition.
		</p>
		<p class="para">Default: <span class="code varname">data_dir</span> + <span class="file filename">"/help"</span>.
		</p>
		<p class="para"><span class="file filename">stardict-dirs.cfg</span> key: help_dir.
		</p>
		</dd>
<dt class="terms">log_dir
		</dt>
<dd class="terms">
		<p class="para">A directory for log files.
		</p>
		<p class="para">Windows default: <span class="file filename">C:\Documents and Settings\%USERNAME%\Local Settings\Temp\StarDict</span>.
		</p>
		<p class="para">Other default: <span class="file filename">/var/tmp/stardict</span>.
		</p>
		<p class="para"><span class="file filename">stardict-dirs.cfg</span> key: log_dir.
		</p>
		</dd>
</dl></div></div>
</div></div>
<div class="note" title="Note">
<svg height="24" width="24" version="1.1">
 <g>
  <path class="yelp-svg-fill" d="m4 3h16c0.554 0 1 0.446 1 1v11h-6v6h-11c-0.554 0-1-0.446-1-1v-16c0-0.554 0.446-1 1-1z"></path>
  <path class="yelp-svg-fill" d="m17 16h4l-5 5v-4c0-0.554 0.446-1 1-1z"></path>
 </g>
</svg><div class="inner"><div class="region"><div class="contents">
	<p class="para">Default values in the list above are given for the purpose of illustrating possible values of variables. Actual default value depends on a number of factors and cannot be computed easily. See AppDirs class in the <span class="file filename">conf.h</span> file for details on how the default value is calculated.
	</p>
	</div></div></div>
</div>
</div></div>
</div></section><section id="stardict-details-logging" class="sect2"><div class="inner">
<div class="hgroup pagewide"><h2 class="title">Logging</h2></div>
<div class="region"><div class="contents pagewide">
<p class="para"><span class="app application">StarDict</span> may log messages into a file. By default logging is turned off, you may enable it specifing non-zero log level with <span class="cmd parameter">--log-level</span> command line option, see <a class="xref" href="stardict-details.html#stardict-details-command-line" title="Command line options">Command line options</a>. 
	</p>
<p class="para">
	By default messages are printed on to console, log file may be useful if console is not available like in Windows. Log may be useful in troubleshooting startup problems. 
	</p>
<p class="para">
	For default location of the log directory see <a class="xref" href="stardict-details.html#stardict-details-dirs" title="StarDict directories">StarDict directories</a>, log_dir parameter. <span class="app application">StarDict</span> log files are named like <span class="file filename">stardict-<span class="var replaceable">process_number</span>.log</span>. We need to use process numbers to create unique log files, since multiple <span class="app application">StarDict</span> instances may run at the same time. To find the log file belonging to the most recently started instance of <span class="app application">StarDict</span>, consider file creation time.
	</p>
</div></div>
</div></section><section id="stardict-details-GUI-lang" class="sect2"><div class="inner">
<div class="hgroup pagewide"><h2 class="title">Interface language</h2></div>
<div class="region"><div class="contents pagewide">
<p class="para">
	This section describes the algorithm used to select interface language in <span class="app application">StarDict</span>.
	</p>
<div class="list orderedlist"><div class="inner"><div class="region"><div class="contents"><ol class="list orderedlist">
<li class="list orderedlist">
	<a name="GUILangStarDictLoader"></a>
	<p class="para">
	Retrieve <span class="code varname">STARDICTLANG</span> environment variable. Goto <a class="xref" href="stardict-details.html#GUILangSetLANG" title="Details">3</a> if the variable is defined.
	</p>
	</li>
<li class="list orderedlist">
	<a name="GUILangUserDefLocale"></a>
	<p class="para">
	Retrieve the user default locale
	(to set the default locale:
	<span class="guiseq menuchoice"><span class="gui guibutton">Control Panel</span> ▸ <span class="gui guibutton">Regional and Language Options</span> ▸ <span class="gui guibutton">Regional Options</span> ▸ <span class="gui guilabel">Standards and formats</span> ▸ <span class="gui guilabel">Language</span></span>).
	If locale is not defined, use "en".
	</p>
	</li>
<li class="list orderedlist">
	<a name="GUILangSetLANG"></a>
	<p class="para">
	Assign the language code to the <span class="code varname">LANG</span> environment variable.
	</p>
	</li>
<li class="list orderedlist">
	<a name="GUILangGetLANGUAGE"></a>
	<p class="para">
	Retrieve the value of the environment variable <span class="code varname">LANGUAGE</span>.
	This is a GNU extension.  Its value can be a colon-separated list of locale names.
	If defined, goto <a class="xref" href="stardict-details.html#GUILangAvailableTransl" title="Details">8</a>.
	</p>
	</li>
<li class="list orderedlist">
	<a name="GUILangGetPOSIXVars"></a>
	<p class="para">
	The value of the environment variable <span class="code varname">LC_ALL</span>, <span class="code varname">LC_xxx</span>, or <span class="code varname">LANG</span>.
	More precisely, the first among these that is set to a non-empty value.
	This is how POSIX specifies it.  The value is a single locale name.
	If defined, goto <a class="xref" href="stardict-details.html#GUILangAvailableTransl" title="Details">8</a>.
	</p>
	</li>
<li class="list orderedlist">
	<a name="GUILangGetSystemLangs"></a>
	<p class="para">
	A system-dependent preference list of languages.  Its value can be a
	colon-separated list of locale names.
	If defined, goto <a class="xref" href="stardict-details.html#GUILangAvailableTransl" title="Details">8</a>.
	</p>
	</li>
<li class="list orderedlist">
	<a name="GUILangGetDefaultLocale"></a>
	<p class="para">
	A system-dependent default locale name.
	If defined, goto <a class="xref" href="stardict-details.html#GUILangAvailableTransl" title="Details">8</a>.
	</p>
	</li>
<li class="list orderedlist">
	<a name="GUILangAvailableTransl"></a>
	<p class="para">
	Processes the found value as a colon-separated list of language codes. Select the first available language. If none is available, select no translation.
	</p>
	</li>
</ol></div></div></div></div>
<div class="note note-warning" title="Warning">
<svg height="24" width="24" version="1.1">
 <path class="yelp-svg-fill" d="m11.92 3.3047a1.3872 1.3872 0 0 0 -1.129 0.6933l-8.6055 14.922a1.3872 1.3872 0 0 0 1.2012 2.08l17.226-0.008a1.3872 1.3872 0 0 0 1.201 -2.08l-8.619-14.916a1.3872 1.3872 0 0 0 -1.136 -0.6913 1.3872 1.3872 0 0 0 -0.139 0zm0.08 4.6953a1 1 0 0 1 1 1v6a1 1 0 0 1 -1 1 1 1 0 0 1 -1 -1v-6a1 1 0 0 1 1 -1zm0 9a1 1 0 0 1 1 1 1 1 0 0 1 -1 1 1 1 0 0 1 -1 -1 1 1 0 0 1 1 -1z"></path>
</svg><div class="inner"><div class="region"><div class="contents">
	<p class="para">Steps <a class="xref" href="stardict-details.html#GUILangGetLANGUAGE" title="Details">4</a> through <a class="xref" href="stardict-details.html#GUILangAvailableTransl" title="Details">8</a> describe translation selection algorithm of the gettext package. The actual procedure may be different.
	</p>
	</div></div></div>
</div>
<p class="para">
	The best way to specify interface language of <span class="app application">StarDict</span> is to define <span class="code varname">STARDICTLANG</span> environment variable. It should contain language code. See <span class="file filename">$StarDictDataDir/locale</span> for the list of supported languages.
	</p>
</div></div>
</div></section><section id="stardict-details-dictionaries" class="sect2"><div class="inner">
<div class="hgroup pagewide"><h2 class="title">StarDict dictionaries</h2></div>
<div class="region">
<div class="contents pagewide">
<p class="para">
    <span class="app application">StarDict</span> supports two types of dictionaries: index (normal) dictionaries and tree dictionaries.
    The vast majority of dictionaries for <span class="app application">StarDict</span> you may find on Internet are of the index type.
    In fact, you hardly find a tree dictionary for <span class="app application">StarDict</span>. 
    An index dictionary contain a list of words in one file and corresponding definitions in other file.
    That index of words is the reason we call it an index dictionary.
    An index dictionary may contain other data as well. 
    In a tree dictionary data are organized in a tree that is why it name.
    <span class="app application">StarDict</span> searches index and tree dictionaries in different directories.
    </p>
<div class="note" title="Note">
<svg height="24" width="24" version="1.1">
 <g>
  <path class="yelp-svg-fill" d="m4 3h16c0.554 0 1 0.446 1 1v11h-6v6h-11c-0.554 0-1-0.446-1-1v-16c0-0.554 0.446-1 1-1z"></path>
  <path class="yelp-svg-fill" d="m17 16h4l-5 5v-4c0-0.554 0.446-1 1-1z"></path>
 </g>
</svg><div class="inner"><div class="region"><div class="contents">
    <p class="para">Almost all files constituting a dictionary are binary. It does not make sense to open them in a text editor. A notable exception is <span class="file filename">.ifo</span> file, it contains dictionary description.
    </p>
    </div></div></div>
</div>
<div class="terms variablelist"><div class="inner">
<div class="title"><h3><span class="title">Index dictionary files and directories</span></h3></div>
<div class="region"><div class="contents"><dl class="terms variablelist">
<dt class="terms">
<span class="var replaceable">dictname</span>.ifo
      </dt>
<dd class="terms">
      <p class="para">Information about the dictionary. This a text file, you may open it in a text editor. You may found useful information here like dictionary description, author name and e-mail.</p>
      </dd>
<dt class="terms">
<span class="var replaceable">dictname</span>.idx or <span class="var replaceable">dictname</span>.idx.gz
      </dt>
<dd class="terms">
      <p class="para">Index of words available in the dictionary.</p>
      </dd>
<dt class="terms">
<span class="var replaceable">dictname</span>.dict or <span class="var replaceable">dictname</span>.dict.dz
      </dt>
<dd class="terms">
      <p class="para">Main content of the dictionary ‒ articles.</p>
      </dd>
<dt class="terms">
<span class="var replaceable">dictname</span>.syn
      </dt>
<dd class="terms">
      <p class="para">Index of synonyms. Optional.</p>
      </dd>
<dt class="terms">
<span class="var replaceable">dictname</span>.idx.oft
      </dt>
<dd class="terms">
      <p class="para">Cache for the index file. This file is created by <span class="app application">StarDict</span> to speedup dictionaries loading. You should not redistribute this file.</p>
      </dd>
<dt class="terms">
<span class="var replaceable">dictname</span>.syn.oft
      </dt>
<dd class="terms">
      <p class="para">Cache for the synonyms file. This file is created by <span class="app application">StarDict</span> to speedup dictionaries loading. You should not redistribute this file.</p>
      </dd>
<dt class="terms">
<span class="var replaceable">dictname</span>.idx.clt
      </dt>
<dd class="terms">
      <p class="para">Collation file for the index file. This file is created by <span class="app application">StarDict</span> when you use collations to modify sorting order of words. You should not redistribute this file.</p>
      </dd>
<dt class="terms">
<span class="var replaceable">dictname</span>.syn.clt
      </dt>
<dd class="terms">
      <p class="para">Collation file for the synonyms file. This file is created by <span class="app application">StarDict</span> when you use collations to modify sorting order of words. You should not redistribute this file.</p>
      </dd>
<dt class="terms">res.rifo, res.ridx, res.rdic
      </dt>
<dd class="terms">
      <p class="para">Files of resource database. It contains resources like images, sound and video files used in the dictionary. Optional.</p>
      </dd>
<dt class="terms">res.ridx.oft
      </dt>
<dd class="terms">
      <p class="para">Cache for the resource index file. This file is created by <span class="app application">StarDict</span> to speedup resource database loading. You should not redistribute this file.</p>
      </dd>
<dt class="terms">res
      </dt>
<dd class="terms">
      <p class="para">A directory containing dictionary resources. This is alternative to <span class="file filename">res.rifo</span>, <span class="file filename">res.ridx</span>, <span class="file filename">res.rdic</span> collection of files. Optional.</p>
      </dd>
</dl></div></div>
</div></div>
<div class="terms variablelist"><div class="inner">
<div class="title"><h3><span class="title">Tree dictionary files</span></h3></div>
<div class="region"><div class="contents"><dl class="terms variablelist">
<dt class="terms">
<span class="var replaceable">dictname</span>.ifo
      </dt>
<dd class="terms">
      <p class="para">Information about the dictionary. This a text file, you may open it in a text editor. You may found useful information here like dictionary description, author name and e-mail.</p>
      </dd>
<dt class="terms">
<span class="var replaceable">dictname</span>.tdx or <span class="var replaceable">dictname</span>.tdx.gz
      </dt>
<dd class="terms">
      <p class="para">A word list forming a tree.</p>
      </dd>
<dt class="terms">
<span class="var replaceable">dictname</span>.dict or <span class="var replaceable">dictname</span>.dict.dz
      </dt>
<dd class="terms">
      <p class="para">Main content of the dictionary ‒ articles.</p>
      </dd>
</dl></div></div>
</div></div>
</div>
<section id="stardict-details-dictionaries-dirs" class="sect3"><div class="inner">
<div class="hgroup pagewide"><h3 class="title">Directories</h3></div>
<div class="region"><div class="contents pagewide">
<p class="para">This section describes directories where <span class="app application">StarDict</span> searches dictionaries.
    </p>
<p class="para">Under <span class="productname">Unix</span>, <span class="app application">StarDict</span> searches <span class="file filename">~/.stardict/dic</span> and <span class="file filename">/usr/share/stardict/dic</span> directories for index dictionaries and <span class="file filename">~/.stardict/treedict</span> and <span class="file filename">/usr/share/stardict/treedict</span> directories for tree dictionaries. If you build <span class="app application">StarDict</span> with non-standard prefix, the application searches a pair of additional directories for dictionaries. It checks <span class="file filename"><span class="code varname">$(datadir)</span>/dic</span> for index dictionaries and <span class="file filename"><span class="code varname">$(datadir)</span>/treedict</span> for tree dictionaries. Here <span class="code varname">$(datadir)</span> is an <span class="app application">autoconf</span> directory variable.
    
    </p>
<p class="para">Under <span class="productname">Windows</span>, <span class="app application">StarDict</span> searches <span class="file filename">C:\Program Files\StarDict\dic</span> for index dictionaries and <span class="file filename">C:\Program Files\StarDict\treedict</span> for tree dictionaries, assuming that <span class="app application">StarDict</span> was installed into <span class="file filename">C:\Program Files\StarDict</span>. If you've install <span class="app application">StarDict</span> into a different directory, replace <span class="file filename">C:\Program Files\StarDict</span> with real installation path.
    </p>
<p class="para">Under <span class="productname">Windows</span>, you may overwrite <span class="code varname">$data_dir</span> variable, see <a class="xref" href="stardict-details.html#stardict-details-dirs" title="StarDict directories">StarDict directories</a>. By default it matches the <span class="app application">StarDict</span> installation directory. In this case <span class="app application">StarDict</span> will search <span class="file filename"><span class="code varname">$data_dir</span>\dic</span> for index dictionaries and <span class="file filename"><span class="code varname">$data_dir</span>\treedict</span> for tree dictionaries.
    </p>
<div class="note" title="Note">
<svg height="24" width="24" version="1.1">
 <g>
  <path class="yelp-svg-fill" d="m4 3h16c0.554 0 1 0.446 1 1v11h-6v6h-11c-0.554 0-1-0.446-1-1v-16c0-0.554 0.446-1 1-1z"></path>
  <path class="yelp-svg-fill" d="m17 16h4l-5 5v-4c0-0.554 0.446-1 1-1z"></path>
 </g>
</svg><div class="inner"><div class="region"><div class="contents">
    <p class="para">All directories are processed recusively.
    </p>
    </div></div></div>
</div>
</div></div>
</div></section>
</div>
</div></section>
</div>
<nav class="prevnext pagewide"><div class="inner">
<a href="manage-plugins.html" title="Manage Plugins">Previous</a><a href="stardict-portable.html" title="StarDict Portable">Next</a>
</div></nav><div class="clear"></div></article><footer><div class="inner pagewide"><footer class="about ui-expander" role="contentinfo"><div class="yelp-data yelp-data-ui-expander" data-yelp-expanded="false"></div>
<div class="inner">
<div class="hgroup"><h2><span class="title">About</span></h2></div>
<div class="region"><div class="contents">
<div class="copyrights"><div class="copyright">© <span class="year">2003</span>, <span class="year">2004</span>, <span class="year">2005</span>, <span class="year">2006</span>, <span class="year">2007</span>, <span class="year">2008</span>, <span class="year">2009</span>, <span class="year">2010</span> <span class="holder">Hu Zheng</span>
</div></div>
<div class="credits">
<div class="credits-authors">
<div class="title"><span class="title">Written By</span></div>
<ul class="credits"><li><span class="author"><span class="firstname">Hu</span> <span class="surname">Zheng</span></span></li></ul>
</div>
<div class="credits-translators">
<div class="title"><span class="title">Translated By</span></div>
<ul class="credits">
<li><span class="othercredit"><span class="firstname">Will</span> <span class="surname">Robinson</span></span></li>
<li><span class="othercredit"><span class="firstname">Новица</span> <span class="surname">Наков</span></span></li>
<li><span class="othercredit"><span class="firstname">Ruud</span> <span class="surname">Slaats</span></span></li>
<li><span class="othercredit"><span class="firstname">Александр</span> <span class="surname">Мурыгин</span></span></li>
<li><span class="othercredit"><span class="firstname">Сергій</span> <span class="surname">Дубик</span></span></li>
</ul>
</div>
<div class="credits-publishers">
<div class="title"><span class="title">Published By</span></div>
<ul class="credits"><li><span class="publishername"> GNOME Documentation Project </span></li></ul>
</div>
</div>
<div class="license">
<div class="title"><span class="title">Legal</span></div>
<div class="contents">
<p class="para">
           Permission is granted to copy, distribute and/or modify this
           document under the terms of the GNU Free Documentation
           License (GFDL), Version 1.2 or any later version published
           by the Free Software Foundation with no Invariant Sections,
           no Front-Cover Texts, and no Back-Cover Texts.  You can find
           a copy of the GFDL at this <a href="help:fdl" class="ulink" title="help:fdl">link</a> or in the file COPYING-DOCS
           distributed with this manual.
          </p>
<p class="para"> This manual is part of a collection of GNOME manuals
           distributed under the GFDL.  If you want to distribute this
           manual separately from the collection, you can do so by
           adding a copy of the license to the manual, as described in
           section 6 of the license.
         </p>
<p class="para">
           Many of the names used by companies to distinguish their
           products and services are claimed as trademarks. Where those
           names appear in any GNOME documentation, and the members of
           the GNOME Documentation Project are made aware of those
           trademarks, then the names are in capital letters or initial
           capital letters.
         </p>
<p class="para">
           DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
           UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
           WITH THE FURTHER UNDERSTANDING THAT:
 
           <div class="list orderedlist"><div class="inner"><div class="region"><div class="contents"><ol class="list orderedlist">
<li class="list orderedlist">
                   <p class="para">DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
                     WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
                     IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
                     THAT THE DOCUMENT OR MODIFIED VERSION OF THE
                     DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
                     A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
                     RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
                     OF THE DOCUMENT OR MODIFIED VERSION OF THE
                     DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
                     MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
                     YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
                     CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
                     SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
                     OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
                     LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
                     VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
                     EXCEPT UNDER THIS DISCLAIMER; AND
                   </p>
                 </li>
<li class="list orderedlist">
                   <p class="para">UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
                        THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
                        CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
                        INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
                        DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
                        OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
                        PARTIES, BE LIABLE TO ANY PERSON FOR ANY
                        DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
                        CONSEQUENTIAL DAMAGES OF ANY CHARACTER
                        INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
                        OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
                        MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
                        LOSSES ARISING OUT OF OR RELATING TO USE OF THE
                        DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
                        EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
                        THE POSSIBILITY OF SUCH DAMAGES.
                   </p>
                 </li>
</ol></div></div></div></div>
         </p>
</div>
</div>
<div class="license">
<div class="title"><span class="title">Feedback</span></div>
<div class="contents"><p class="para">To report a bug or make a suggestion regarding the <span class="app application">StarDict</span> application or
		this manual, follow the directions in the 
		<a href="help:gnome-feedback" class="ulink" title="help:gnome-feedback">GNOME Feedback Page</a>. 
		</p></div>
</div>
</div></div>
</div></footer></div></footer>
</div></main></body>
</html>
